package io.xccit.race.service;

import java.util.List;
import java.util.Map;
import io.xccit.race.domain.RaceCompetitionResult;

/**
 * 竞赛成果物Service接口
 * 
 * @author ywx
 * @date 2025-10-13
 */
public interface IRaceCompetitionResultService {
    
    /**
     * 查询竞赛成果物
     * 
     * @param id 竞赛成果物主键
     * @return 竞赛成果物
     */
    public RaceCompetitionResult selectRaceCompetitionResultById(Long id);
    
    /**
     * 查询竞赛成果物列表
     * 
     * @param raceCompetitionResult 竞赛成果物
     * @return 竞赛成果物集合
     */
    public List<RaceCompetitionResult> selectRaceCompetitionResultList(RaceCompetitionResult raceCompetitionResult);
    
    /**
     * 新增竞赛成果物
     * 
     * @param raceCompetitionResult 竞赛成果物
     * @return 结果
     */
    public int insertRaceCompetitionResult(RaceCompetitionResult raceCompetitionResult);
    
    /**
     * 修改竞赛成果物
     * 
     * @param raceCompetitionResult 竞赛成果物
     * @return 结果
     */
    public int updateRaceCompetitionResult(RaceCompetitionResult raceCompetitionResult);
    
    /**
     * 批量删除竞赛成果物
     * 
     * @param ids 需要删除的竞赛成果物主键集合
     * @return 结果
     */
    public int deleteRaceCompetitionResultByIds(Long[] ids);
    
    /**
     * 删除竞赛成果物信息
     * 
     * @param id 竞赛成果物主键
     * @return 结果
     */
    public int deleteRaceCompetitionResultById(Long id);
    
    /**
     * 根据竞赛ID查询成果物列表
     * 
     * @param competitionId 竞赛ID
     * @return 成果物列表
     */
    public List<RaceCompetitionResult> selectRaceCompetitionResultByCompetitionId(Long competitionId);
    
    /**
     * 根据报名记录ID查询成果物
     * 
     * @param signupId 报名记录ID
     * @return 成果物
     */
    public RaceCompetitionResult selectRaceCompetitionResultBySignupId(Long signupId);
    
    /**
     * 根据用户ID查询成果物列表
     * 
     * @param userId 用户ID
     * @return 成果物列表
     */
    public List<RaceCompetitionResult> selectRaceCompetitionResultByUserId(Long userId);
    
    /**
     * 统计成果物数量
     * 
     * @return 成果物总数
     */
    public Long selectRaceCompetitionResultCount();
    
    /**
     * 统计审核状态分布
     * 
     * @return 审核状态统计
     */
    public List<Map<String, Object>> selectAuditStatusDistribution();
    
    /**
     * 统计竞赛成果物数量
     * 
     * @param competitionId 竞赛ID
     * @return 成果物数量
     */
    public Long selectResultCountByCompetitionId(Long competitionId);
    
    /**
     * 审核成果物
     * 
     * @param raceCompetitionResult 成果物信息
     * @return 结果
     */
    public int auditRaceCompetitionResult(RaceCompetitionResult raceCompetitionResult);
    
    /**
     * 提交成果物
     * 
     * @param raceCompetitionResult 成果物信息
     * @return 结果
     */
    public int submitRaceCompetitionResult(RaceCompetitionResult raceCompetitionResult);
}
